home *** CD-ROM | disk | FTP | other *** search
Text File | 2002-10-03 | 121.3 KB | 2,377 lines |
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- NNNNAAAAMMMMEEEE
- swmgr, SoftwareManager - software manager
-
- SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
- sssswwwwmmmmggggrrrr [ ----nnnnNNNN ] [ ----ffff source ] [ ----mmmm hardware====value ] [ ----rrrr target ]
- [ ----uuuu action ] [ ----FFFF selections-file ] [ ----IIII selection ]
- [ ----RRRR selection ] [ ----KKKK selection ] [ ----XXXX file ] [ ----YYYY file ]
- [ ----VVVV preference::::value ] [ -------- X-command-line-option ... ]
-
- SSSSooooffffttttwwwwaaaarrrreeeeMMMMaaaannnnaaaaggggeeeerrrr [ swmgr_options ]
-
- DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
- _s_w_m_g_r is the graphical tool used to install, remove, and browse software
- distributed by Silicon Graphics.
-
- _S_o_f_t_w_a_r_e_M_a_n_a_g_e_r invokes _s_w_m_g_r with the arguments provided after prompting
- for the root password if one is necessary.
-
- The ----ffff option specifies the location of new software to be installed.
- The _s_o_u_r_c_e argument is either a single _d_i_s_t_r_i_b_u_t_i_o_n, or a directory
- containing one or more distributions. Software distributions are in a
- format defined by Silicon Graphics and that can be read only by _s_w_m_g_r and
- _i_n_s_t(1M). See the _i_n_s_t__d_e_v product for creating your own software
- distributions.
-
- _s_w_m_g_r can read the distribution from a local drive (tape, CD-ROM or
- disk), or from a remote directory, web site, or drive connected to the
- same network as your workstation. See the _i_n_s_t(_1_M) manual page for a
- full description of possible distribution media.
-
- The command line options are:
-
- ----ffff _s_o_u_r_c_e
- Specify the location of the software distribution. The format of
- _s_o_u_r_c_e depends on the location of the distribution and other
- factors. Multiple -f arguments are permitted. The possibilities
- are:
-
- ttttaaaappppeeee local tape drive
-
- ////ddddeeeevvvv////nnnnrrrrttttaaaappppeeee local tape drive
-
- ////CCCCDDDDRRRROOOOMMMM////ddddiiiisssstttt local CD-ROM drive
-
- _d_i_s_t_d_i_r local distribution directory _d_i_s_t_d_i_r
-
- ////CCCCDDDDRRRROOOOMMMM////ddddiiiisssstttt////_p_r_o_d_u_c_t
- installing just _p_r_o_d_u_c_t from a local CD-ROM drive
-
- _d_i_s_t_d_i_r////_p_r_o_d_u_c_t installing just _p_r_o_d_u_c_t from a local distribution
- directory
-
-
-
-
- PPPPaaaaggggeeee 1111
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- nnnnoooonnnneeee for browsing or removing installed software only
-
- _s_e_r_v_e_r::::////ddddeeeevvvv////ttttaaaappppeeee
- tape drive on a remote workstation whose hostname is
- _s_e_r_v_e_r
-
- _s_e_r_v_e_r::::_C_D_d_i_r////ddddiiiisssstttt
- CD-ROM drive with the CD mounted at _C_D_d_i_r on a
- remote workstation whose hostname is _s_e_r_v_e_r
-
- _s_e_r_v_e_r::::_d_i_s_t_d_i_r distribution directory _d_i_s_t_d_i_r on a remote
- workstation whose hostname is _s_e_r_v_e_r
-
- _s_e_r_v_e_r::::_C_D_d_i_r////ddddiiiisssstttt////_p_r_o_d_u_c_t
- installing just _p_r_o_d_u_c_t from a CD mounted at _C_D_d_i_r
- on a remote workstation whose hostname is _s_e_r_v_e_r
-
- _s_e_r_v_e_r::::_d_i_s_t_d_i_r////_p_r_o_d_u_c_t
- installing just _p_r_o_d_u_c_t from a distribution
- directory _d_i_s_t_d_i_r on a remote workstation whose
- hostname is _s_e_r_v_e_r
-
- _h_t_t_p://_s_e_r_v_e_r/_d_i_s_t_d_i_r/
- installing from a web site. This functionality
- requires that the libwio.so library be installed on
- the local system.
-
- _h_t_t_p://_s_e_r_v_e_r/_d_i_s_t_d_i_r/_f_i_l_e._t_a_r_d_i_s_t
- download the tardist file, and unpack into a local
- temporary directory before installing. Tardist
- files may be used in conjunction with a .inst
- selections file so that installations initiated from
- a web browser will not block the browser during the
- download. See -F, TARDIST and SELECTIONS FILE
- below.
-
- When using a remote distribution source, you can prepend _u_s_e_r@@@@ to
- specify a user ID other than guest as discussed above. For example,
- to use a remote tape drive on bigserver as user iiiinnnnssssttttuuuusssseeeerrrr, the ----ffff
- argument is iiiinnnnssssttttuuuusssseeeerrrr@@@@bbbbiiiiggggsssseeeerrrrvvvveeeerrrr::::////ddddeeeevvvv////ttttaaaappppeeee.
-
- ----rrrr _t_a_r_g_e_t
- Set the effective root directory in which the new software will be
- installed. By default, this is ////. This option is used to specify
- the root of a virtual IRIX tree for diskless prototype trees.
-
- The -r option may also be used to install software somewhere other
- than the default location. However, by changing the effective root
- directory, the normal installation history database in /var/inst
- will not be used, and inst may not be able to to correctly resolve
- prerequisite conflicts. Therefore when attempting to manage disk
- space, it is usually preferable to avoid using the -r option, and
-
-
-
- PPPPaaaaggggeeee 2222
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- instead create a symbolic link from the system disk to an option
- drive before running inst or Software Manager.
-
- For example, if a product installs files into the directory
- /usr/share/foo, you can make a symbolic link (see ln(1)) from
- /usr/share/foo to /disk2/usr/share/foo, and then run inst or
- Software Manager without the -r option to install the product's
- files into /disk2. A record of the installation will still be
- maintained under /var/inst.
-
- The -r option cannot be used to create a bootable system disk for
- the same or an alternate OS or machine. Such a disk is normally
- created by running inst in the miniroot environment.
-
- ----IIII _s_e_l_e_c_t_i_o_n
- Specify products or subsystems to install, where _s_e_l_e_c_t_i_o_n is a
- product name, or other expression accepted by the _i_n_s_t iiiinnnnssssttttaaaallllllll
- command. Multiple expressions can be specified by using a comma
- separated list or by using multiple ----IIII options.
-
- ----RRRR _s_e_l_e_c_t_i_o_n
- Specify products or subsystems to remove, where _s_e_l_e_c_t_i_o_n is a
- product name, or other expression accepted by the _i_n_s_t rrrreeeemmmmoooovvvveeee
- command. Multiple expressions can be specified by using a comma
- separated list or by using multiple ----RRRR options.
-
- ----KKKK _s_e_l_e_c_t_i_o_n
- Specify products to keep (don't install or remove), where _s_e_l_e_c_t_i_o_n
- is a product name, or other expression accepted by the _i_n_s_t kkkkeeeeeeeepppp
- command. Multiple expressions can be specified by using a comma
- separated list or by using multiple ----KKKK options.
-
- ----VVVV _p_r_e_f_e_r_e_n_c_e::::_v_a_l_u_e
- Initialize _p_r_e_f_e_r_e_n_c_e to _v_a_l_u_e. See PREFERENCES.
-
- ----FFFF _s_e_l_e_c_t_i_o_n_s-_f_i_l_e
- The _s_e_l_e_c_t_i_o_n_s-_f_i_l_e is used to pre-select subsystems for
- installation or removal. A remote selections file is allowed using
- user@host:file or http://server/selections.inst. By convention
- selections files located on the web have a .inst suffix. See
- SELECTIONS FILE below for complete syntax.
-
- ----cccc _f_i_l_e
- Causes inst to execute commands in the order that they appear in
- _f_i_l_e. Unless the quit command is used, inst will resume in
- interactive mode after processing the file. Control-C can be used
- to summon the interrupt menu. Normally Inst will stop processing
- the file if an error occurs, and present the interactive menu,
- unless the aaaabbbboooorrrrtttt____oooonnnn____eeeerrrrrrrroooorrrr preference is set to off. This option is
- ignored by SoftwareManager.
-
-
-
-
-
- PPPPaaaaggggeeee 3333
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- ----MMMM Do not display _i_n_s_t output using its built-in pager, and do not show
- percent-done messages. Equivalent to setting ppppaaaaggggeeee____oooouuuuttttppppuuuutttt====ooooffffffff and
- sssshhhhoooowwww____ppppeeeerrrrcccceeeennnntttt____ddddoooonnnneeee====ooooffffffff.
-
- ----EEEE Invoke iiiinnnnsssstttt____tttteeeerrrrsssseeee____mmmmooooddddeeee. Provides reduced output for scripting.
- Equivalent to setting iiiinnnnsssstttt____tttteeeerrrrsssseeee____mmmmooooddddeeee====oooonnnn in the shell environment
- before invoking _i_n_s_t. If set on, it minimizes _i_n_s_t output: most
- normal status and progress messages are suppressed unless explicitly
- asked for, but any warnings, errors, and explicitly requested output
- still appear. See the description of the preference iiiinnnnsssstttt____tttteeeerrrrsssseeee____mmmmooooddddeeee
- within _i_n_s_t or _s_w_m_g_r for more information.
-
- ----PPPP _f_i_l_e
- Specify _f_i_l_e to be pppprrrreeeecccciiiioooouuuussss. See PREFERENCES.
-
- ----NNNN Disables space-checking by initializing the _s_p_a_c_e__c_h_e_c_k preference
- to _o_f_f. See PREFERENCES.
-
- ----uuuu _a_c_t_i_o_n
- Specify the type of subsystems to select for installation. The
- possible actions are:
-
- nnnneeeewwww Select all new products for installation.
-
- uuuuppppggggrrrraaaaddddeeee Select all upgrade products for installation.
-
- uuuuppppggggrrrraaaaddddeeee____aaaannnndddd____nnnneeeewwww Select all new and upgrade products for
- installation.
-
- uuuuppppggggrrrraaaaddddeeee____oooorrrr____nnnneeeewwww Select upgrade (or new, if no upgrades) products
- for installation.
-
- uuuuppppggggrrrraaaaddddeeee____aaaannnndddd____rrrrnnnnddddssss____oooorrrr____nnnneeeewwww
- Select upgrade and related new default subsystems
- (or new defaults, if no upgrades, no downgrades
- and no same) for installation. (This is the
- default action.)
-
- aaaallllllll Select all products for installation.
-
- ----XXXX _f_i_l_e
- Exclude _f_i_l_e during installations and removals. If _f_i_l_e is a
- directory, its descendents are also excluded. Multiple ----XXXX options
- are permitted, however wildcards are not. To quickly rebuild a
- corrupted installation history, re-install the same versions of your
- existing software using -_X/ (no files will be touched). See also
- the _e_x_c_l_u_s_i_o_n_s preference.
-
- ----YYYY _f_i_l_e
- Install only _f_i_l_e during installations and removals. If _f_i_l_e is a
- directory, only it and its descendents are installed or removed.
- Multiple ----YYYY options are permitted, however wildcards are not. See
-
-
-
- PPPPaaaaggggeeee 4444
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- the _r_e_s_t_r_i_c_t_i_o_n_s preference.
-
- ----UUUU Run the tool in _e_x_t_r_a_c_t__m_o_d_e, useful for recreating a source tree
- from a set of images produced by _g_e_n_d_i_s_t(1M). See PREFERENCES.
-
- ----TTTT Run the tool in _s_y_m_l_i_n_k__m_o_d_e, useful for creating a tree of symbolic
- links, instead of regular files. See PREFERENCES.
-
- ----nnnn Initialize the _d_r_y_r_u_n preference to _o_n. See PREFERENCES.
-
- ----CCCC Install software for all architectures that support diskless
- clients. This is normally used only when installing (on the server)
- the share tree for diskless clients. It will only work correctly
- with products designed for use with diskless clients (that is, the
- different hardware-specific files are installed with different names
- for each hardware type). Some products install files with the same
- name, regardless of architecture, and this option will not allow
- such products to install all files in a unique way.
-
- Normally used by _s_h_a_r_e__i_n_s_t(1M), this option is used to install
- sharable software (including hardware-specific files) for all
- architectures listed in the file indicated by the _m_a_c_h__c_l_a_s_s_f_i_l_e
- preference. See PREFERENCES.
-
- ----ssss Install shared software for use by diskless clients. This option is
- normally used only by _s_h_a_r_e__i_n_s_t(1M) when constructing a share-tree
- for diskless clients.
-
- ----SSSS _s_h_a_r_e_t_r_e_e
- Install software for diskless client, and specify the shared tree.
- This option is normally used only by _c_l_i_e_n_t__i_n_s_t(1M) when installing
- the diskless client-specific software. When this option is given
- _i_n_s_t installs the non-sharable software that is used exclusively by
- an individual diskless client.
-
- ----HHHH This option causes _i_n_s_t to print the hardware variables and then
- exit. See the ----mmmm option, and the aaaaddddmmmmiiiinnnn hhhhaaaarrrrddddwwwwaaaarrrreeee command of inst.
-
- ----ZZZZ Re-writes the installation history in /var/inst using the IRIX 6.2
- inst format. Inst will refuse to perform this operation if any
- overlay maintenance products are installed. This option is silently
- ignored by _s_w_m_g_r.
-
- ----mmmm _h_a_r_d_w_a_r_e====_v_a_l_u_e
- Specify an alternate type of hardware for the installation. See the
- _i_n_s_t(_1_M) manual page for a full description of this option.
-
- SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNN KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
- Some inst commands accept keyword arguments as shorthand ways of choosing
- groups of subsystems. These keywords may also be used with the -I, -R
- and -K command-line otions, in selections files (-F), in command files
- (-c), and in the SoftwareManager command-pane.
-
-
-
- PPPPaaaaggggeeee 5555
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- If more than one keyword is given within a single install, remove, keep,
- etc. command, the intersection of the keywords is taken. This means that
- the command applies only to subsystems satisfying all of the keywords.
-
- The following list gives each keyword, its abbreviation if it has one,
- and a brief description.
-
- aaaallllllll,,,, aaaa All subsystems in "showprods -a" output plus all
- subsystems in the software distribution.
-
- cccclllliiiieeeennnnttttoooonnnnllllyyyy,,,, cccc All subsystems that are only for nfs-client installs
- (see share_inst(1M)).
-
- ddddeeeeffffaaaauuuulllltttt,,,, dddd All subsystems in the distribution that are marked
- with "d".
-
- ddddiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn All subsytems in the current distribution(s).
-
- ddddiiiisssstttt:::: When followed by a colon (::::), selects all subsytems
- in any distribution whose name contains the string
- ddddiiiisssstttt. Useful when multiple distributions are open.
-
- ddddoooowwwwnnnnggggrrrraaaaddddeeee,,,, DDDD All subsystems that have a version installed that is
- newer than the version in the software distribution.
-
- hhhhaaaarrrrddddwwwwaaaarrrreeee,,,, hhhh All subsystems containing hardware-specific files.
-
- iiiinnnnssssttttaaaallllllll,,,, iiii All subsystems that are selected for installation.
-
- iiiinnnnssssttttaaaallllllllaaaabbbblllleeee,,,, AAAA All subsystems in the software distribution, except
- certain patches, hardware-specific and clientonly
- subsystems that are inappropriate for the current
- target.
-
- uuuunnnniiiinnnnssssttttaaaallllllllaaaabbbblllleeee,,,, XXXX All subsystems in the software distribution that are
- inappropriate for the current target.
-
- ccccoooonnnnfffflllliiiiccccttttiiiinnnngggg,,,, CCCC All subsystems currently selected for installation or
- removal, that are causing conflicts. Useful with
- "keep conflicting".
-
- pppprrrreeeerrrreeeeqqqqssss The minimal set of unselected distribution subsystems
- that will resolve all current prereq conflicts.
- Useful with "install prereqs".
-
- iiiinnnnssssttttaaaalllllllleeeedddd,,,, IIII All subsystems that are installed on the target.
-
- kkkkeeeeeeeepppp,,,, kkkk All installed subsystems that are not selected for
- re-installation, replacement or removal.
-
-
-
-
-
-
- PPPPaaaaggggeeee 6666
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- rrrreeeebbbbooooooootttt,,,, bbbb All subsystems that require a reboot to complete
- installation.
-
- nnnneeeewwww,,,, NNNN,,,, nnnn All subsystems that aren't installed, and aren't
- upgrades or downgrades of something installed.
-
- nnnnoooottttiiiinnnnssssttttaaaalllllllleeeedddd All subsystems on the target that have neither been
- installed nor removed.
-
- ppppaaaattttcccchhhheeeessss All patches in the distribution.
-
- ppppaaaattttcccchhhhuuuuppppggggrrrraaaaddddeeee,,,, PPPP All patches in the distribution that are upgrades to
- installed patches.
-
- rrrreeeemmmmoooovvvvaaaabbbblllleeee,,,, LLLL All of the installed subsystems that can be selected
- for removal.
-
- rrrreeeemmmmoooovvvveeee,,,, rrrr All of the subsystems that are selected for removal.
-
- rrrreeeemmmmoooovvvveeeedddd,,,, RRRR All subsystems that were once installed.
-
- rrrreeeeqqqquuuuiiiirrrreeeedddd,,,, qqqq All of the subsystems that are required for proper
- operation of the workstation.
-
- ssssaaaammmmeeee,,,, SSSS,,,, ssss All subsystems that have an identical version
- installed.
-
- ssssttttaaaannnnddddaaaarrrrdddd This keyword is useful for performing a software
- upgrade, by using the command sequence kkkkeeeeeeeepppp ****
- followed by iiiinnnnssssttttaaaallllllll ssssttttaaaannnnddddaaaarrrrdddd. In Software Manager,
- an equivalent option is available on the Install
- menu. If the distribution contains any related
- (same, upgrade or downgrade) subsystems, then
- standard refers to upgrade subsystems plus new,
- default sibling subsystems (in the same product) that
- were not part of the product the last time they were
- installed. However if the distribution contains no
- related products (in other words, all products are
- new) then standard will select all default
- subsystems. Finally, standard will also include any
- prerequisite products (see pppprrrreeeerrrreeeeqqqqssss) but not overlay
- subsystems whose base subsystems are missing (see
- iiiinnnnccccoooommmmpppplllleeeetttteeeeoooovvvveeeerrrrllllaaaayyyyssss). Standard will not select
- downgrade or currently installed (same) subsystems or
- subsystems that are incompatible with your hardware.
-
- ssssttttaaaalllleeee All installed subsystems on the target that must be
- re-installed due to hardware changes.
-
- ffffrrrreeeesssshhhh The subset of ssssttttaaaalllleeee subsystems that are also on the
- current distribution. For example, the command
- iiiinnnnssssttttaaaallllllll ffffrrrreeeesssshhhh may be used to re-install software that
-
-
-
- PPPPaaaaggggeeee 7777
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- has been affected by a hardware upgrade.
-
- ttttaaaarrrrggggeeeetttt All subsytems on the target.
-
- uuuuppppggggrrrraaaaddddeeee,,,, UUUU All subsystems that have a version installed that is
- older than the version in the software distribution.
-
- uuuuppppggggrrrraaaaddddeeeedddd,,,, uuuu Any subsystem on the target that is being removed as
- part of an installation of a related (typically
- newer) version of the product from the distribution.
-
- aaaapppppppplllliiiiccccaaaabbbblllleeeeppppaaaattttcccchhhheeeessss All patches in the distribution that are installable
- based on the current selections.
-
- oooovvvveeeerrrrllllaaaayyyyssss All overlay products in the distribution.
-
- iiiinnnnccccoooommmmpppplllleeeetttteeeeoooovvvveeeerrrrllllaaaayyyyssss The subset of overlay products which cannot be
- installed because the corresponding base product is
- not installed, and is not loaded in the distribution
- view.
-
- mmmmaaaaiiiinnnntttt This keyword may only be used with the command
- "install maint" and is used to switch from the
- feature stream to the maintenance stream. This
- command will change the setting of the "stream"
- preference to "maint", clear the current selections,
- set the "neweroverride" preference to "on", and make
- the standard upgrade selections (see the ssssttttaaaannnnddddaaaarrrrdddd
- keyword), plus downgrade selections, necessary for
- switching to the maintenance stream. This command
- should only be used when "stream" is currently set to
- "feature" and after opening a distribution containing
- maintenance products.
-
- ffffeeeeaaaattttuuuurrrreeee This keyword may only be used with the command
- "install feature" and is used to switch from the
- maintenance stream to the feature stream. This
- command will change the setting of the "stream"
- preference to "feature", clear the current
- selections, and make the standard upgrade selections
- (see the ssssttttaaaannnnddddaaaarrrrdddd keyword) necessary for switching to
- the maintenance streams. This command should only be
- used when "stream" is currently set to "maint" and
- after opening a distribution containing feature
- products.
-
- SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNNSSSS FFFFIIIILLLLEEEE
- A sssseeeelllleeeeccccttttiiiioooonnnnssss----ffffiiiilllleeee can be used to specify the distribution(s) and the
- selections for a single installation session. Blank lines and comment
- lines that begin with a pound-sign (####) are ignored. All other lines must
- be selections file directives.
-
-
-
-
- PPPPaaaaggggeeee 8888
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- The software distribution is specified using the ffffrrrroooommmm directive. This
- directive can be omitted from the selections file if the distribution has
- already been read and the user uses the aaaaddddmmmmiiiinnnn llllooooaaaadddd command. A selections
- file can contain multiple distribution directives.
-
- ffffrrrroooommmm _d_i_s_t_r_i_b_u_t_i_o_n
- ffffrrrroooommmm _d_i_s_t_d_i_r_1 _d_i_s_t_d_i_r_2
- ffffrrrroooommmm ////CCCCDDDDRRRROOOOMMMM////ddddiiiisssstttt
- ffffrrrroooommmm _h_o_s_t::::_d_i_s_t_r_i_b_u_t_i_o_n
- ffffrrrroooommmm _u_s_e_r@_h_o_s_t::::_d_i_s_t_r_i_b_u_t_i_o_n
- ffffrrrroooommmm _h_t_t_p://_s_e_r_v_e_r/_d_i_s_t_d_i_r/_f_i_l_e._t_a_r_d_i_s_t
-
- _i_n_s_t preference values can be specified for the installation session by
- using the sssseeeetttt directive. These directives can appear anywhere in the
- file and all preference directives are interpreted together in the order
- that they appear.
-
- sssseeeetttt _p_r_e_f_e_r_e_n_c_e _v_a_l_u_e
-
- The product/subsystem selections for the installation session are
- specified using the selections directives. The selections directives can
- appear anywhere in the file and all selections directives are interpreted
- together in the order that they appear. The directives are specified
- using their abbreviated forms, and include iiii (install), rrrr (remove), and kkkk
- (do not remove or install). These directives take one or more arguments
- that can be a product or subsystem name ((wildcards are permitted), or
- selection keyword described above.
-
- i eoe.sw.cdrom
- i default eoe.sw32.*
- i installable patches
-
- k conflicting
- k *
-
- r *.books.* *.man.*
-
-
-
- KKKKEEEEEEEEPPPP FFFFIIIILLLLEEEE
- A kkkkeeeeeeeeppppffffiiiilllleeee can be used to prevent unwanted products from being marked for
- default installation. If the file /_v_a_r/_i_n_s_t/._k_e_e_p_f_i_l_e exists, its
- contents are processed each time a new distribution is loaded. The
- keepfile lists new (N) products, images, or subsystems that are not to be
- marked for default installation. Upgrade (U) subsystems are not affected
- by the keepfile. The keepfile only affects the initial selections made
- by inst or swmgr when a distribution is loaded.
-
- The _i_n_s_t command aaaaddddmmmmiiiinnnn uuuuppppddddaaaatttteeeekkkkeeeeeeeeppppffffiiiilllleeee updates the keepfile with respect
- to the current selections. New default subsystems that are not selected
- for installation are appended to the keepfile.
-
-
-
-
- PPPPaaaaggggeeee 9999
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- The keepfile contains one pattern per line. Only the first whitespace-
- separated pattern on each line is considered. A wildcard character, ****,
- can be used in the pattern. For example eoe.books.* turns off default
- installation of all new subsystems in the eoe.books image. Comments
- beginning with #### and ending with a newline are ignored.
-
- TTTTAAAARRRRDDDDIIIISSSSTTTT FFFFIIIILLLLEEEE
- A ttttaaaarrrrddddiiiisssstttt ffffiiiilllleeee is a distribution, encoded as a _t_a_r(_1_m) file. A tardist
- file can be used to distribute a small product or set of products for
- installation over a network.
-
- When the specified distribution is a tardist file, _i_n_s_t and _s_w_m_g_r unpack
- the distribution into a temporary directory (in /var/tmp), and the
- tardist file's length is zeroed to save space. Once the installation has
- completed, _i_n_s_t and _s_w_m_g_r give you the option of deleting the temporary
- distribution or saving it for future use.
-
- If you decide to save the distribution for later use, it is usually saved
- in the directory /usr/dist (normally expected to be a world-writable
- directory for unpacking and storing distributions). However, you can
- save the distribution to another directory if desired.
-
- Tardist files are intended to be used to install distributions located on
- the World Wide Web. Normally a page will be created with a link to a
- selections file. The selections file will specify a tardist file (as a
- URL). Your web browser (e.g., _n_e_t_s_c_a_p_e) will download the selections
- file and invoke _s_w_m_g_r. _S_w_m_g_r will read the selections file, download the
- specified tardist file, unpack the distribution, and install the
- software.
-
- Tardist files must have the extension ._t_a_r_d_i_s_t in order to be recognized
- as such by _i_n_s_t, _s_w_m_g_r, and web browsers (e.g., _n_e_t_s_c_a_p_e).
-
- FFFFIIIILLLLEEEESSSS
- /var/inst/.swmgrrc most recent values of permanent sssseeeetttt options
- /var/inst/.keepfile new subsystems not selected for default install
- /var/inst/help1 source for online help
- /var/inst/INSTLOG log of installation sessions
- /var/inst/hist database of the files installed on your workstation
- by inst and swmgr.
- /var/inst/_p_r_o_d_u_c_t binary files, each describing an installed product
- /usr/dist directory, writable by the user, in which the
- contents of the tardist can be saved
- /usr/lib/libwio.so http protocol support libraries
- /usr/lib32/libwio.so
-
- PPPPRRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
- A number of preferences are available for customizing _i_n_s_t and _s_w_m_g_r.
- Preferences are loaded from /_v_a_r/_i_n_s_t/._s_w_m_g_r_r_c, /._s_w_m_g_r_r_c, ~/._s_w_m_g_r_r_c,
- and from the command line, with command-line definitions having the
- highest precedence.
-
-
-
-
- PPPPaaaaggggeeee 11110000
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- The modifiers in the following descriptions are:
-
- iiiinnnnsssstttt----oooonnnnllllyyyy used only by _i_n_s_t
- sssswwwwmmmmggggrrrr----oooonnnnllllyyyy used only by _s_w_m_g_r
- ppppeeeerrrrmmmmaaaannnneeeennnntttt saved across sessions
- eeeexxxxppppeeeerrrrtttt for experts only
- rrrreeeeaaaaddddoooonnnnllllyyyy cannot be modified by the user
- bbbboooooooolllleeeeaaaannnn An on/off value (true/false may also be used)
-
- aaaabbbboooorrrrtttt____ccccmmmmddddffffiiiilllleeee____oooonnnn____eeeerrrrrrrroooorrrr
- Abort command-file installation (-c) on errors
- boolean, default: true (inst-only expert)
- Controls how errors are handled during command-file (-c)
- installations. If "on" (the default) the installation stops
- after an error and present an interrupt menu. If "off",
- commands the remaining commands in the command-file are
- executed despite any errors. In all cases errors are
- reported in /var/inst/INSTLOG. See also abort_on_error.
-
-
- aaaabbbboooorrrrtttt____oooonnnn____eeeerrrrrrrroooorrrr
- Abort automatic installation on errors
- boolean, default: off (inst-only permanent expert)
- Controls how errors are handled during automatic (-a)
- installations. If "on" the installation terminates
- immediately. If "off" (the default) the installation
- continues. In all cases errors are reported in
- /var/inst/INSTLOG. See also abort_cmdfile_on_error.
-
-
- aaaallllllll____aaaarrrrcccchhhhiiiitttteeeeccccttttuuuurrrreeeessss
- Install all architectures
- boolean, default: off (readonly)
- Controls whether files for all architectures are installed.
- This preference applies during diskless share-tree or
- client-tree installations, and can only be set with the -C
- command line option. See client_inst(1).
-
-
- aaaallllwwwwaaaayyyyssss____ccccoooonnnnffffiiiirrrrmmmm____qqqquuuuiiiitttt
- Confirm quit action
- boolean, default: off (permanent)
- Controls whether the user is always asked for confirmation
- of a quit command.
-
-
- aaaallllwwwwaaaayyyyssss____ppppaaaaggggeeee____iiiinnnnsssstttt
- Page optional output
- boolean, default: off (inst-only expert)
- Controls whether inst output not specifically requested,
- such as progress messages during actual installation, are
- paged or displayed non-stop.
-
-
-
- PPPPaaaaggggeeee 11111111
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- aaaauuuuttttooooccccoooonnnnffffiiiigggg____oooovvvveeeerrrrhhhheeeeaaaadddd
- Autoconfig overhead, in bytes
- integer, default: 286720 (expert)
- Controls the amount of disk space reserved during the
- installation for temporary disk space required by
- autoconfig(1M) to build a new kernel. Under special
- circumstances when a debug kernel is being built, this value
- should be doubled. See also "kernel_size_32" and
- "kernel_size_64".
-
-
- aaaauuuuttttooooddddeeeesssseeeelllleeeecccctttt Automatically de-select failing subsystems
- default: confirm, choices: on confirm off
- This preference controls whether to skip
- installation/removal of subsystems causing certain types of
- errors during the pre-installation check, after "go" or
- "start" is issued. If set to "on", and if no conflicts
- would result, the failing subsystems are automatically de-
- selected, and the installation is re-tried. If set to
- "confirm" (the default), the user is prompted before
- deselecting. If set to "off", no de-selecting is attempted.
- Currently only NFS-readonly errors are handled in this
- fashion, as may occur when books and manual pages are NFS-
- mounted from another host, and you attempt to install
- documentation locally.
-
-
- aaaauuuuttttoooommmmaaaattttiiiicccc Automatic installation
- boolean, default: off
- Controls whether the installation proceeds without user
- intervention.
-
-
- aaaauuuuttttooooppppaaaattttcccchhhhsssseeeelllleeeecccctttt
- Automatic patch selections
- boolean, default: on
- Controls whether installable patches are automatically
- selected when the appropriate base subsystem is installed or
- selected for install. When this preference is "on", patches
- marked for install will be automatically deselected when the
- associated base subsystem is marked for removal or
- deselected for install.
-
-
- aaaauuuuttttoooosssseeeelllleeeecccctttt Automatic installation selections
- boolean, default: on
- Controls whether initial selections are made from the list
- of subsystems to be installed whenever a new distribution is
- opened. Unless overridden by other means, such as the -I,
- -R, -K, and -u command line options, this will be all
- upgrade (U) subsystems and all new default (Nd) subsystems
- in the distribution.
-
-
-
- PPPPaaaaggggeeee 11112222
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- bbbbaaaacccckkkkggggrrrroooouuuunnnndddd Background the application
- boolean, default: on (swmgr-only permanent expert)
- Controls whether SoftwareManager is run in the foreground or
- in the background when invoked from a shell.
-
-
- bbbbeeeeeeeepppp Beep when installation completes
- boolean, default: on (permanent)
- Controls whether or not an audible "beep" signal is issued
- whenever an installation is successfully completed.
-
-
- bbbbuuuussssyyyy____cccchhhheeeecccckkkk Busy file space checking
- boolean, default: on (expert)
- Controls whether busy files (those which are currently
- accessed by executing processes) are considered during the
- pre-installation space check. If busy files are removed or
- overwritten during the installation, their disk blocks are
- not immediately reclaimed by the operating system. Closing
- other applications before a live-install may be required in
- order for the disk space requirements to be met. In the
- miniroot, the busy check is always skipped.
-
-
- cccchhhheeeecccckkkkppppooooiiiinnnntttt____rrrreeeessssttttaaaarrrrtttt
- Automatically restart install if set
- boolean, default: off (expert)
- Used for checkpoint restarting. Automatically restart
- installation if set.
-
-
- cccchhhheeeecccckkkkppppooooiiiinnnntttt____rrrreeeessssttttaaaarrrrtttt____mmmmooooddddeeee
- Override normal checkpoint restart mode
- string, default: NULL
- Specifies the initial user interface mode used for
- checkpoint restarting. Brings up SoftwareManager in a
- specific mode, overriding any value set by the user in
- "custom_startup_mode".
-
-
- cccchhhheeeecccckkkkppppooooiiiinnnntttt____sssseeeelllleeeeccccttttiiiioooonnnnssss
- Checkpoint before go as well as during go
- boolean, default: off (permanent expert)
- Controls whether or not to checkpoint the selections during
- the selection process. This is useful when making complex
- selections worth saving.
-
-
- cccclllleeeeaaaarrrrpppprrrroooommmmpppptttt Clear the "more?" prompt
- boolean, default: on (inst-only permanent)
- Controls the way in which some prompts are displayed.
- Certain operations use "throw away" prompts that are usually
-
-
-
- PPPPaaaaggggeeee 11113333
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- cleared by backspacing, then overwritten with spaces. For
- terminals that can't clear prompts in this way, it is more
- appropriate to just move to the next line. Set clearprompt
- "off" to use the simple case. It is "on" by default and
- saved from session to session.
-
-
- ccccoooolllluuuummmmnnnnssss Number of columns in tty display
- integer, default: 0 (inst-only permanent)
- The "columns" preference is not supported in this release,
- but will be supported in a future release. In this release
- the number of columns is automatically detected by inst (if
- possible), but cannot be overridden.
-
-
- ccccoooonnnnffffiiiirrrrmmmm____nnnnffffssss____iiiinnnnssssttttaaaallllllllssss
- Confirm installs onto nfs-mounted filesystems
- boolean, default: on (permanent)
- Controls installs onto nfs-mounted filesystems. If set to
- "on", the user is asked to confirm any installations to
- nfs-mounted directories located on another host. When set
- to "off", inst or SoftwareManager will install on to nfs-
- mounted filesystems as long as the user has the necessary
- permissions.
-
-
- ccccoooonnnnffffiiiirrrrmmmm____qqqquuuuiiiitttt Confirm quit if pending actions
- boolean, default: on (permanent)
- Controls whether the user is notified that install/remove
- actions are pending when quitting.
-
-
- ccccuuuussssttttoooommmm____ssssttttaaaarrrrttttuuuupppp____mmmmooooddddeeee
- SoftwareManager initial selections mode
- default: off, choices: off distribution always (permanent
- expert)
- Controls how SoftwareManager is initially presented.
- Possible values are: "off" - always start in automatic mode;
- "distribution" - start in custom-selections mode if a
- distribution has been specified, otherwise in automatic
- mode; "always" - start in custom-selections mode if a
- distribution has been specified, otherwise in manage-
- installed-software mode.
-
-
- ddddeeeebbbbuuuugggg____mmmmeeeennnnuuuu Debug menu
- boolean, default: off (swmgr-only)
- Controls whether the debug menu is available in swmgr.
-
-
-
-
-
-
-
- PPPPaaaaggggeeee 11114444
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- ddddeeeeffffaaaauuuulllltttt____ccccoooonnnnffffiiiigggg
- Force default configuration files
- boolean, default: off (permanent expert)
- Controls whether to override the normal configuration file
- rules, and install ALL the configuration files from the
- distribution. If the user has modified these files, they are
- first saved with a ".O" suffix.
-
-
- ddddeeeeffffaaaauuuulllltttt____ddddiiiisssstttt The name of the default distribution from which to read.
- string, default: NULL (readonly)
- If no distribution is supplied by the user on the command
- line, this is used as the default installation location if
- set. See also "dist" and "distribution".
-
-
- ddddeeeeffffaaaauuuulllltttt____sssshhhhaaaarrrreeeeddddiiiirrrrssss
- Default share directories
- string, default: /usr (readonly expert)
- Contains the list of default share directories used in a
- diskless share-tree or client-tree installation.
-
-
- ddddeeeellllaaaayyyy____ccccoooonnnnfffflllliiiiccccttttssss
- Controls when certain conflicts are presented
- default: ask, choices: ask on off
- Controls when certain "delayable" conflicts are presented to
- the user. Currently, only particular incompat conflicts may
- be delayed. The default behavior, "ask", will query the user
- when the first delayable conflict is presented. At that
- time, the user will have the option of resolving the
- conflict before the installation or prior to exiting. In
- some installation scenarios, the conflict will have to be
- delayed since the subsystem(s) necessary to resolve the
- conflict are not on the current distribution. After making a
- choice, this behavior will continue for the remainder of the
- installation session or until the preference value is
- explicitly changed. An "on" value will always present the
- delayable conflicts prior to exiting. An "off" selection
- will present all conflicts, including the delayable variety,
- prior to installation. This preference is not saved from
- session to session. To make this preference persistent, add
- "delay_conflicts:" and the desired value to the .swmgrrc
- file.
-
-
- ddddeeeellllaaaayyyy____eeeexxxxiiiittttooooppppssss
- Controls when exitops are executed
- boolean, default: off (permanent)
- Controls when exitops are executed. When this preference is
- "off", the default case, exitops are executed immediately
- after all files are installed and before control is returned
-
-
-
- PPPPaaaaggggeeee 11115555
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- to the user. When this preference is "on", the exitops will
- not be executed until the user quits. If the user interrupts
- an installation and chooses to save the exitops for later
- execution, any unexecuted exitops will be executed upon
- exiting the application.
-
-
- ddddeeeellllaaaayyyy____iiiiddddbbbb____rrrreeeeaaaadddd
- Delay reading of distribution idb files.
- default: default, choices: default on off
- If set to "on", inst will delay reading of the distribution
- idb files until after the Go/Start command is initiated.
- This will result in significant speedup when reading large
- distributions and less memory usage by inst or swmgr since
- only necessary idb lines will be read into memory. Commands
- such as "admin files" that require access to the
- distribution files will cause the required distribution idb
- files to be read. If set to "off", the reading of the
- distribution idb files will never be delayed. If set to
- "default", the reading of distribution idb files will be
- delayed unless the installation medium is CD. CDs are
- treated specially because delaying the reading of idb files
- would require extra CD switches in a multi-CD install. If
- the user is installing from only 1 CD at a time or is
- comfortable with extra CD switches, this preference may be
- set to "on".
-
-
- ddddeeeellllaaaayyyyssssppppaaaacccceeeecccchhhheeeecccckkkk
- Delay disk space checks until go
- boolean, default: off (permanent)
- Controls the timing of disk space calculations. If
- "delayspacecheck" is "off", disk space calculation is done
- when a "list", "step", or "space" command is given if no
- disk space calculation has yet been done for the current
- software distribution. If "delayspacecheck" is "on", disk
- space calculation is deferred until the "go" or "space"
- commands are given. When "delayspacecheck" is "on", no disk
- space information is displayed by the "list" or "step"
- commands.
-
-
- ddddeeeettttaaaaiiiillllssssppppaaaacccceeeecccchhhheeeecccckkkk
- Detailed space checking
- boolean, default: off (permanent)
- Controls the data used for disk space calculations. If
- "detailspacecheck" is "on", size and type of every file
- installed on the system via inst is obtained by stat-ing the
- file on the disk. If "detailspacecheck" is "off", the state
- of every file is assumed to be the same as that saved in the
- history database and that information is used to make the
- disk space calculations. "detailspacecheck" is slower, but
-
-
-
- PPPPaaaaggggeeee 11116666
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- more accurate.
-
-
- ddddiiiissssaaaabbbblllleeee____kkkkeeeeeeeeppppffffiiiilllleeee
- Suppress keepfile processing
- boolean, default: off
- If set, the normal keepfile processing is skipped. Entries
- in $rbase/var/inst/.keepfile will be ignored and the initial
- installation selections will be unaffected by the .keepfile
- entries. See the "keepfile" help topic.
-
-
- ddddiiiissssaaaabbbblllleeee____pppprrrreeeerrrreeeeqqqq____hhhhiiiinnnnttttssss
- Disable processing of the .prereq_hints file
- boolean, default: off
- If a .prereq_hints file is found in the distribution
- directory, inst/swmgr will read this file and use the
- product/version to distribution/CD mapping to help the user
- figure out where prereq'd products reside. Turning this
- option on disables this processing.
-
- ddddiiiissssaaaabbbblllleeee____rrrreeeeddddiiiirrrreeeecccctttt Ignore redirect file in distribution
- boolean, default: off (expert)
- Controls behavior when a .redirect file is found in a
- distribution. If "on", the .redirect file is evaluated and
- the distribution is redirected as specified. If "off" (the
- default), the specified distribution is used. Please note
- that setting this preference to "off" may result in some
- products being skipped if they have been produced for a
- newer version of inst or SoftwareManager. You should not
- enable this preference unless you explicitly want to attempt
- to view products that are not normally intended for
- installation on your OS version or hardware platform.
-
-
- ddddiiiissssaaaabbbblllleeee____rrrreeeellllaaaatttteeeedddd____ddddiiiissssttttssss
- Ignore related dists file
- boolean, default: off (expert)
- If set, inst will ignore any .related_dists file that is
- found on the distribution.
-
-
- ddddiiiisssskkkk____aaaavvvvaaaaiiiillll Override available space on target filesystems
- string, default: NULL
- This preference specifies the free space (in bytes) used in
- disk space calculations. If set to a single value, like
- "50M" or "1000" then it will apply to all filesystems. To
- set the free space of specific filesystems, use the form:
- "fs:size|fs:size|..." For example, a value of
- "/:4096|/usr:50M" will result in 4096 bytes available on the
- / filesystem, and 50M on /usr. This preference is used for
- debugging only. See also "disk_blocksize" and
-
-
-
- PPPPaaaaggggeeee 11117777
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- "disk_capacity".
-
-
- ddddiiiisssskkkk____bbbblllloooocccckkkkssssiiiizzzzeeee
- Override blocksize of target filesystems
- string, default: NULL
- This preference specifies an alternate blocksize (in bytes)
- used in disk space calculations. If set to a single value,
- like "1024", or "4k", then it will apply to all filesystems.
- To set the blocksize for specific filesystems, use the form:
- "fs:blocksize|fs:blocksize|..." For example, a value of
- "/:512|/usr:4k" will result in a blocksize of 512 bytes on
- the / filesystem, and 4096 byes on the /usr filesystem.
- Blocksizes should be a multiple of 512 bytes. This
- preference is used for debugging only. See also
- "disk_avail" and "disk_capacity".
-
-
- ddddiiiisssskkkk____ccccaaaappppaaaacccciiiittttyyyy
- Override capacity of target filesystems
- string, default: NULL
- This preference specifies an alternate filesystem size (in
- bytes) used in disk space calculations. If set to a single
- value, like "50M" or "500k" then it will apply to all
- filesystems. To set the size of specific filesystems, use
- the form: "fs:size|fs:size|..." For example, a value of
- "/:300k|/usr:100M|/d2:100000" will result in a size of 300
- kilobytes on the / filesystem, 100 megabytes on /usr, and
- 100000 bytes on /d2. This preference is used for debugging
- only. See also "disk_avail" and "disk_blocksize".
-
-
- ddddiiiisssskkkklllleeeessssssss Diskless mode
- default: none, choices: none share client (readonly)
- Controls whether the tool is operating on a normal (non-
- diskless) tree, a diskless share tree, or a diskless client
- tree.
-
-
- ddddiiiissssppppllllaaaayyyy____ssssiiiizzzzeeee Units for product sizes
- default: kbytes, choices: bytes blocks kbytes (inst-only)
- Controls the units (bytes, kilobytes, or 512-byte blocks)
- used to display product sizes.
-
-
- ddddiiiisssstttt Most recent distribution source
- string, default: NULL (permanent)
- Each time product descriptions are read, the current
- software distribution source (see help from) becomes the
- value of "dist". (A product name, if included in the "from"
- argument, is not saved in "dist".) You can use the value of
- "dist" in your "from" commands using the syntax "$dist", for
-
-
-
- PPPPaaaaggggeeee 11118888
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- example "from $dist/eoe2". The command "from none" results
- in no distribution being read, and sets the view to target
- for browsing or removing installed software. The value of
- dist is saved from session to session.
-
-
- ddddiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn The name of the distribution supplied by the user.
- string, default: NULL (readonly)
- This is the name of the distribution supplied by the user on
- the command line. See also "dist".
-
-
- ddddrrrryyyyrrrruuuunnnn Dryrun mode
- boolean, default: off
- Controls whether operating in dryrun mode. In this mode, the
- names of files which would have otherwise been installed or
- removed are displayed. Even with dryrun mode enabled, some
- configuration files in $rbase/var/inst may be created or
- written and temp directories (/usr/tmp,/var/tmp) under
- $rbase will be created if necessary.
-
-
- eeeennnnaaaabbbblllleeee____aaaauuuuttttoooommmmiiiinnnniiiirrrrooooooootttt____ccccoooommmmppppaaaattttiiiibbbbiiiilllliiiittttyyyy
- Create 6.3/6.4 compatible command file
- boolean, default: off
- This option controls whether the command file created for
- autominiroot installations is compatible with the 6.3/6.4
- miniroot. This option is only required if doing an
- autominiroot install from CD using a 6.3/6.4 miniroot.
-
-
- eeeerrrrrrrroooorrrr____ccccoooorrrreeeedddduuuummmmpppp
- Force coredump on X errors
- boolean, default: off (swmgr-only)
- Controls whether errors in the X Windows interface result in
- an immediate coredump.
-
-
- eeeexxxxcccclllluuuussssiiiioooonnnnssss List of excluded files
- string, default: NULL (expert)
- This preference holds the list of excluded files, separated
- by whitespace or the '|' character. Excluded files (and, for
- directories, their descendents) are not installed or removed
- during a "go". A value of "none" indicates no exclusions
- are in effect. The -X command line option may also be used
- to specify the exclusions. If this preference is changed
- during an interactive session, any previous disk space
- calculations may become out of date. Use the "admin recalc"
- command in inst or the "Recalculate Disk Space" command in
- SoftwareManager to determine the new space requirements.
- See also "restrictions".
-
-
-
-
- PPPPaaaaggggeeee 11119999
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- eeeexxxxiiiittttoooopppp____lllliiiimmmmiiiitttt Exitop output limit
- integer, default: 100000 (expert)
- This is the maximum output allowed from exitops (shell
- commands executed at the end of the installation). Output
- over this limit is not displayed or logged. Also applies to
- preops and postops (commands executed immediately before or
- after a file is installed) and removeops (executed after a
- file is removed). Removeops are only executed when a
- subsystem is removed, for example with "versions remove",
- but not when a subsystem is upgraded.
-
-
- eeeexxxxttttrrrraaaacccctttt____mmmmooooddddeeee Extract images to original source tree
- boolean, default: off (readonly)
- Controls whether inst or SoftwareManager operates in extract
- mode. In this mode, files are installed under their original
- source names (relative to the effective root) used to create
- the images. Only regular files (not directories, symlinks,
- etc.) are installed. No conflict checking, rqs processing,
- or machtag matching is performed. This preference must be
- set before reading the distribution, preferably on the
- command line using the -U option.
-
-
- ffffuuuullllllllmmmmeeeennnnuuuu Display hidden commands
- boolean, default: off (inst-only permanent)
- Controls the list of commands shown in menus. If fullmenu is
- "off" (the default), the most commonly used commands are
- displayed in the menus. If fullmenu is "on", all commands
- that are available are shown in the menus, and all the
- hidden commands are displayed, too. This preference changes
- only the display of commands, not their availability. It is
- "off" by default and saved from session to session.
-
-
- hhhhiiiiddddeeee____iiiimmmmaaaaggggeeee____pppprrrroooodddduuuuccccttttssss
- Controls the display of image-level products.
- boolean, default: on (permanent expert)
- If "hide_image_products" is "on" (the default), image-level
- products are not displayed. The value of
- "hide_image_products" is saved between installation
- sessions.
-
-
- hhhhttttttttpppp____ppppiiiicccckkkkyyyy Require special format distribution file in an HTTP
- distribution.
- boolean, default: on (permanent expert)
- Require special format distribution file in an HTTP
- distribution, rather than trying to adapt to any directory
- format the HTTP server may see fit to provide.
-
-
-
-
-
- PPPPaaaaggggeeee 22220000
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- iiiinnnnsssstttt____iiiinnnniiiittttiiiiaaaallll____lllleeeevvvveeeellll
- Inst product display level
- default: subsystem, choices: product subsystem (permanent
- expert)
- Controls the initial level of products displayed in inst.
-
-
- iiiinnnnsssstttt____tttteeeerrrrsssseeee____mmmmooooddddeeee
- Reduced output for scripting
- boolean, default: off (inst-only expert)
- If set "on", inst output is minimized: most normal status
- and progress messages are suppressed unless explicitly asked
- for, but any warnings, errors and explicitly requested
- output still appear. Also forces "page_output" "off",
- "show_diskspace" "off", "show_legend" "off",
- "show_percent_done" "off", "show_files" "off" and
- "verbosity" to the value "1". Useful for automated scripts
- driving inst. See also the -F<selections-file> command line
- option, the inst "admin save" and "admin load" commands, and
- the "verbose" preference.
-
-
- iiiinnnnsssstttt____vvvviiiissssiiiibbbblllleeee____pppprrrreeeeffffeeeerrrreeeennnncccceeeessss
- Set of optional preferences to display.
- multivalue, default: permanent,transient,tty, choices:
- permanent transient beginner expert tty gui (inst-only
- permanent beginner)
- Controls the set of optional preferences displayed with the
- "set" command. See also "show_hidden_preferences".
-
-
- iiiinnnnssssttttaaaallllllll____iiiiddddeeeennnnttttiiiiccccaaaallll____ffffiiiilllleeeessss
- Install files even if contents are not new
- boolean, default: on (permanent expert)
- Controls whether to extract files from the distribution even
- if the version on disk has the same size and checksum. If
- "install_identical_files" is set to "off" installations are
- much faster when little has changed from release to release.
- Caution: use this preference only if you are comfortable
- with the accuracy of the checksum -r test to determine
- whether two files of equal length indeed are identical. See
- sum(1m).
-
-
- iiiinnnnssssttttaaaallllllll____mmmmiiiinnnniiiimmmmuuuummmm____oooovvvveeeerrrrllllaaaayyyy____ffffiiiilllleeeessss
- Control number of files installed during overlay installs
- boolean, default: true
- This option seeks to minimize the number of files that are
- installed when the user installs an overlay product.
- Specifically, if the currently installed stream and the
- stream to be installed are derived from the same base
- product, only the minimum required number of base product
-
-
-
- PPPPaaaaggggeeee 22221111
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- files are installed. When set to false, all the base
- product files are reinstalled if the base subsystem is
- included in the distribution. If the required base
- subsystem is not included in the distribution and this
- preference is set to false, the miminum install will still
- be attempted if no files are required from the base product.
-
-
- iiiinnnnssssttttaaaallllllll____ssssiiiitttteeeessss
- List of former install sites
- string, default: NULL (permanent expert)
- Controls the list of former installation sites displayed.
-
-
- iiiinnnnssssttttaaaallllllll____ssssiiiitttteeeessss____ssssiiiizzzzeeee
- Number of items to keep in the install sites list.
- integer, default: 10 (permanent)
- Controls the number of items in the former installation
- sites list.
-
-
- iiiinnnnssssttttmmmmooooddddeeee Type of installation
- default: prototype, choices: normal prototype client
- (expert)
- Controls certain details of how the installation is
- performed. The value is set automatically when the
- installation target is initialized. The "instmode"
- preference is exported as the environment variable $instmode
- for use by exitops. During installs into a bootable target
- (miniroot installs into /root, and live installs into /)
- instmode has the value "normal". During other installs the
- value is "prototype". If the value of "instmode" is changed,
- it is recommended that the "admin recalc" command in inst or
- the "Recalculate Disk Space" command in SoftwareManager be
- used to recalculate space requirements (if any) for the new
- UNIX kernel. See also "diskless".
-
-
- iiiinnnntttteeeerrrraaaaccccttttiiiivvvveeee User interaction control
- boolean, default: on
- Controls whether the user will be prompted for responses to
- questions.
-
-
- kkkkeeeerrrrnnnneeeellll____ssssiiiizzzzeeee____33332222
- Size of 32-bit kernel, in bytes
- integer, default: 6291456 (expert)
- Controls the amount of disk space reserved on 32-bit systems
- for /unix, during installations which will cause a new
- kernel to be built by autoconfig(1M). See also
- "kernel_size_64" and "autoconfig_overhead".
-
-
-
-
- PPPPaaaaggggeeee 22222222
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- kkkkeeeerrrrnnnneeeellll____ssssiiiizzzzeeee____66664444
- Size of 64-bit kernel, in bytes
- integer, default: 8388608 (expert)
- Controls the amount of disk space reserved on 64-bit systems
- for /unix, during installations which will cause a new
- kernel to be built by autoconfig(1M). See also
- "kernel_size_32" and "autoconfig_overhead".
-
-
- lllliiiinnnneeeessss Number of lines in tty display
- integer, default: 0 (inst-only permanent)
- The "lines" preference is not supported in this release, but
- will be supported in a future release. In this release the
- number of lines is automatically detected by inst (if
- possible), but cannot be overridden.
-
-
- lllliiiivvvveeee____iiiinnnnssssttttaaaallllllll Automatically boot miniroot for os installs
- default: default, choices: default on off
- If set to "on", installs of operating system software will
- be allowed in multi-user mode. If set to "default", attempts
- to install operating system software in multi-user mode will
- automatically shut down the machine and proceed to
- automatically boot the miniroot. The user makes selections,
- resolves conflicts, and addresses any disk space issues from
- multi-user mode. The go/start command from multi-user mode
- will initiate the automatic miniroot boot sequence if
- operating system software is being installed. If set to
- "off", inst or swmgr will always attempt to boot the
- miniroot. If no bootable "sa" file is not found in the
- distribution directory and a miniroot install is needed,
- inst or swmgr will fail with an appropriate error message.
- NFS-mounted, remote CDROM, and HTTP distributions are not
- bootable. Local CDROM and remote distributions, such as
- "bigserver:/dist", are bootable. This preference is only
- relevant in multi-user mode when installing into "/". The
- user will always be prompted before the machine is actually
- shut down.
-
-
- lllloooogggg____ppppaaaannnneeee____hhhheeeeiiiigggghhhhtttt
- Height of the log pane in SoftwareManager
- integer, default: 125 (swmgr-only)
- Specifies the height of the log pane in SoftwareManager.
-
-
- lllloooogggg____ppppaaaannnneeee____lllloooogggg____ssssiiiizzzzeeee
- Size of the log pane display
- integer, default: 100000 (swmgr-only permanent)
- Specifies the maximum amount of text that is displayed in
- the log pane before truncation occurs.
-
-
-
-
- PPPPaaaaggggeeee 22223333
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- llllooooggggffffiiiilllleeee____ssssiiiizzzzeeee Size of log file in bytes before recycle
- integer, default: 307200 (permanent)
- Controls the maximum size of the log file
- (/var/inst/INSTLOG).
-
-
- mmmmaaaacccchhhh____ccccllllaaaassssssssffffiiiilllleeee
- Mach classes file
- string, default: /var/boot/.dl_classes (readonly)
- Holds the name of the file containing the hardware chart
- used during diskless installations when the -C argument is
- specified, requesting that all architectures be installed.
-
-
- mmmmaaaacccchhhh____iiiinnnnffffoooo Mach tag values
- string, default: NULL
- Contains the mach tag values that determine which versions
- of hardware-specific files to install. Multiple mach
- expressions separated by the `|' character are permitted. If
- this preference is NULL (the default) the mach values are
- automatically derived according to the current hardware
- configuration on the system.
-
-
- mmmmaaaacccchhhhffffiiiilllleeee Name of the standard mach file.
- string, default: /var/inst/machfile
- Controls the location of the standard machfile.
-
-
- mmmmeeeennnnuuuussss Print menus
- boolean, default: on (inst-only permanent)
- Controls the automatic display of menus. Once you are
- familiar with the menus, you may wish to disable the
- automatic display by setting this preference "off". You can
- redisplay the current menu at any time with a "?" command.
- It is "on" by default and saved from session to session.
-
-
- mmmmiiiinnnniiiirrrrooooooootttt Miniroot install
- boolean, default: off (readonly)
- This flag is on if in the miniroot.
-
-
- mmmmiiiinnnniiiirrrrooooooootttt____ggggrrrraaaapppphhhhiiiiccccssss
- Use miniroot graphics
- default: default, choices: default on off (inst-only)
- Controls whether or not progress is displayed using a
- graphical progress box during miniroot installations. The
- "default" setting will use graphical display of progress and
- other information in the miniroot only during automatic
- miniroot installs. A setting of "on" will always display
- graphics in the miniroot. A setting of "off" will never
-
-
-
- PPPPaaaaggggeeee 22224444
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- display graphics in the miniroot, instead displaying
- information textually. The value of this preference is not
- saved between sessions. Note: the graphical progress bar is
- not available on all hardware platforms.
-
-
- mmmmoooocccckkkk____sssspppprrrroooocccc Disable sprocs
- boolean, default: off
- When set, this disables sproc'ing, so that debugging is
- possible. The command is printed on stdout, and execution
- terminates until something is read from stdin.
-
-
- nnnneeeettttwwwwoooorrrrkkkk____rrrreeeettttrrrryyyy
- Number of network retries
- integer, default: 2 (permanent)
- Holds the number of successive network timeouts allowed
- before giving up on the connection. See "timeout".
-
-
- nnnneeeettttwwwwoooorrrrkkkk____sssseeeeeeeekkkk____tttthhhhrrrreeeesssshhhhoooolllldddd
- Controls behavior of remote seek
- integer, default: 65536
- If seeking forward more than "network_seek_threshold" bytes
- in a remote file, re-start the dd process instead of reading
- and discarding the intervening bytes. This optimization of
- re-starting dd may be disabled by setting
- "network_seek_threshold" to zero. If the remote dd does not
- support the iseek option, "network_seek_threshold" is always
- treated as zero.
-
-
- nnnneeeevvvveeeerrrr____rrrreeeessssiiiizzzzeeee____ppppaaaannnneeee
- Do not resize panes when switching selections modes
- boolean, default: on (swmgr-only permanent expert)
- Controls whether to resize panes when switching between
- automatic installation and custom selections or manage
- installed software modes in SoftwareManager.
-
-
- nnnneeeewwwweeeerrrroooovvvveeeerrrrrrrriiiiddddeeee
- Allows installation of older products
- boolean, default: off
- Controls whether older subsystems can replace newer
- subsystems that are installed. The default value, "off",
- prevents you from installing subsystems that are older than
- what is already installed (i.e., are marked "O" in "list"
- and "step" output). If you want to replace a subsystem with
- an older version, set "neweroverride" to "on". The value of
- this preference is not saved from inst session to inst
- session.
-
-
-
-
- PPPPaaaaggggeeee 22225555
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- nnnnoooonnnn____rrrrooooooootttt Not root user can perform installs/removals
- boolean, default: off (readonly)
- Controls if a non-root user can perform installs/removals.
-
-
- oooovvvveeeerrrrllllaaaayyyy____mmmmooooddddeeee Controls behavior when overlays are loaded
- default: none, choices: none ask silent default
- (permanent_target)
- Controls behavior when overlays are loaded. Set to "ask" to
- prompt users to choose an overlay stream if a distribution
- contains an overlay. Set to "silent" to maintain the setting
- of the "stream" preference and suppress all stream
- preference prompts. Set to "default" to maintain the setting
- of the "stream" preference but revert to prompting when
- there are no remaining stream specific products installed or
- in the distribution. A "none" setting indicates that no
- stream has been chosen; users will be prompted to choose a
- stream.
-
-
- oooovvvveeeerrrrpppprrrriiiinnnntttt Use overprinting for verbose lists
- boolean, default: on (inst-only permanent)
- Controls the manner in which filenames are displayed during
- installations and removals if the preference "show_files" is
- turned on. When this preference is on, scrolling the
- display is significantly reduced by overprinting the file
- names on the same line. If you prefer scrolling as the file
- names are displayed, set this preference "off". It is "on"
- by default and saved from session to session.
-
-
- oooovvvveeeerrrrrrrriiiiddddeeee____ccccooooaaaarrrrsssseeee____cccchhhheeeecccckkkk
- Allow coarse space check to stop install
- boolean, default: true
- This option allows the coarse, pre-go, space check to stop
- the install. By default, this option is disabled since the
- coarse space check is not as accurate as the post-go,
- detailed space check that is performed after the user types
- go in inst or presses start in swmgr.
-
-
- oooovvvveeeerrrrrrrriiiiddddeeee____ssssppppaaaacccceeee____cccchhhheeeecccckkkk
- Override space checking
- boolean, default: off (expert)
- If set to "on", allows "go" despite a disk overflow
- condition.
-
-
- ppppaaaaggggeeee____oooouuuuttttppppuuuutttt Page output
- boolean, default: on (inst-only)
- Controls whether tty output is managed by a paging mechanism
- similar to more(1m).
-
-
-
- PPPPaaaaggggeeee 22226666
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- ppppeeeerrrrmmmm____cccchhhheeeecccckkkk Permissions check
- boolean, default: on
- Controls whether permissions-checking is performed during
- the pre-installation check. When this preference is "on",
- the inst or SoftwareManager will inform you during the pre-
- installation check whether you have permission to install or
- remove files in the affected directories.
-
-
- ppppoooosssstttt____iiiinnnnssssttttaaaallllllll____ddddiiiiaaaalllloooogggg
- Ask about quit after install
- boolean, default: on (permanent expert)
- Controls if a dialog is displayed after an install asking if
- the user wants to quit.
-
-
- pppprrrreeeecccciiiioooouuuussss____ffffiiiilllleeeessss
- List of precious files
- string, default: NULL (expert)
- Holds the list of precious file separated by whitespace,
- specified on the cmd-line or .swmgrrc. Inst or
- SoftwareManager will not overwrite or remove any files which
- the user has designated as precious.
-
-
- pppprrrroooommmmppppttttffffoooorrrriiiidddd Interactive prompt for unknown uid
- boolean, default: off (permanent)
- Controls whether the user will be interactively queried for
- ids corresponding to unknown uids/gids. Unknown uids or gids
- result when a passwd or group file does not contain an id
- for the given name. If "off", inst or SoftwareManager will
- automatically choose the uids/gids (and write them to
- /usr/adm/SYSLOG) based on the value of the "startid"
- preference.
-
-
- rrrreeeemmmmooootttteeee____rrrreeeeaaaadddd____ssssiiiizzzzeeee
- Remote distribution read buffer size
- integer, default: 10240
- Controls the size of the buffer used for reading remote
- distributions.
-
-
- rrrreeeemmmmoooovvvveeeeppppoooolllliiiiccccyyyy Control remove behavior within inst
- default: safe, choices: anything safe
- This option controls what the user is allowed to remove from
- the distribution view in inst. A setting of "anything"
- allows any target products to be marked for removal in the
- distribution view. Conversely, a setting of "safe" while in
- the distribution view only allows targ products with the
- same name as products in the distribution view to be marked
- for removal. For example, with a setting of "safe", the
-
-
-
- PPPPaaaaggggeeee 22227777
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- "remove *" operation in the distribution view would only
- mark for removal target products that have the same name as
- products currently in the distribution view. With a setting
- of "anything", "remove *" in the distribution view would
- mark all target products for removal, regardless of what
- products are in the distribution view.
-
-
- rrrreeeeppppoooorrrrtttt____eeeexxxxiiiitttt____ssssttttaaaattttuuuussss
- Set process exit status
- boolean, default: off (permanent)
- Controls the exit status to be set to various non-zero
- values, depending on what caused the exit.
-
-
- rrrreeeessssttttrrrriiiicccctttteeeedddd Restricted mode
- boolean, default: off (inst-only)
- This preference controls restricted mode in inst.
-
-
- rrrreeeessssttttrrrriiiiccccttttiiiioooonnnnssss List of restricted files
- string, default: NULL (expert)
- Holds the list of restricted files, separated by whitespace
- or the '|' character. Restricted files (and, for
- directories, their descendents) are the only files installed
- or removed during a "go". A value of "none" indicates no
- restrictions are in effect. The -Y command line option may
- be used to specify the restrictions. If this preference is
- changed during an interactive session, any previous disk
- space calculations may become out of date. Use the "admin
- recalc" command in inst or the "Recalculate Disk Space"
- command in SoftwareManager to determine the new space
- requirements. See also "exclusions".
-
-
- rrrrqqqqssss____oooonnnnllllyyyy Requickstart mode
- boolean, default: off
- Controls whether the only operation performed is rqs In this
- mode the installation tool will execute any necessary rqs(1)
- processing, and then exit. This preference can also be set
- with the -Q command line option.
-
-
- rrrrqqqqssss____ttttaaaasssskkkk Fine-control over rqs(1) processing
- default: default, choices: default rqsread rqsall
- If set to "rqsread", then only the first rqs phase will be
- performed (the rqs registry file is updated). If set to
- "rqsall", then only the second rqs phase will be performed
- (executables are requickstarted using the rqs(1) utility).
- Otherwise both phases are performed, as necessary, when the
- installation tool exits.
-
-
-
-
- PPPPaaaaggggeeee 22228888
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- rrrrqqqqssss____ttttiiiimmmmeeeessssttttaaaammmmpppp
- Rqs timestamp
- string, default: NULL
- If this preference is set, its value is passed to the
- rqsall(1) command using the -timestamp argument, during rqs
- processing.
-
-
- rrrruuuulllleeeessssoooovvvveeeerrrrrrrriiiiddddeeee
- Override any conflict
- boolean, default: off
- Controls whether conflicts can be overridden. The default
- value, "off", prevents you from installing subsystems that
- do not meet specified incompat or prereq rules. If you want
- to override these rules, set "rulesoverride" to "on". This
- preference should be used cautiously. "rulesoverride" is not
- saved from session to session. NOTE: it is best to first
- resolve as many conflicts as possible, and then only as a
- last resort use this preference just before "go" or "start"
- to overcome the remaining conflicts. After the installation
- completes, you are advised to set "rulesoverride" back to
- "off" so that conflicts do not go accidentally unnoticed for
- the remainder of the session.
-
-
- sssseeeelllleeeeccccttttiiiioooonnnnssss____ppppaaaannnneeee____hhhheeeeiiiigggghhhhtttt
- Height of the selections pane
- integer, default: 350 (swmgr-only)
- Specifies the height of the selections pane.
-
-
- sssseeeetttt____ppppaaaatttthhhh Control $PATH variable for exitops
- default: default, choices: default environment specific
- (permanent expert)
- Can be set to "default", "environment", or "specific":
- "default" - set path to a known path; "environment" - pass
- $path in from the environment $PATH (or use the default path
- if $PATH is not set); "specific" - use whatever is in the
- preference "set_path_specific".
-
-
- sssseeeetttt____ppppaaaatttthhhh____ssssppppeeeecccciiiiffffiiiicccc
- Path used for exitops
- string, default: NULL (permanent expert)
- Controls the path used for exitops.
-
-
- sssshhhhaaaaddddoooowwww____ffffiiiilllleeeessss List of files to shadow
- string, default: NULL
- Holds the list of shadow files, separated by whitespace,
- specified on the command line or .swmgrrc
-
-
-
-
- PPPPaaaaggggeeee 22229999
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- sssshhhhaaaaddddoooowwwwiiiinnnngggg File shadowing
- boolean, default: NULL (readonly)
- Controls whether special files are shadowed during a live
- (non-miniroot) install.
-
-
- sssshhhhaaaarrrreeeebbbbaaaasssseeee Root of sharetree in client mode
- string, default: NULL
- Holds the name of the root of sharetree in client mode.
-
-
- sssshhhhaaaarrrreeeeppppooooiiiinnnnttttssss Potentially shared, read-only directories.
- string, default: /usr/share|/usr/share/Insight
- Holds a list of directory names, separated by whitespace or
- the '|' character. These should be directory names as listed
- in the installation history (if different from the true
- pathnames on disk). As necessary these directories are
- tested for write-permission at the beginning of the pre-
- installation check. Other readonly directories (as are
- commonly NFS-mounted) take longer to detect the first time.
- As new readonly directories are discovered, the sharepoints
- preference is automatically updated, to speed-up error
- checking in future installations. If set to "none", or to
- an empty string, the sharepoint checking is disabled.
-
-
- sssshhhheeeellllllll Program to use for "sh" and "shroot"
- string, default: /bin/csh (permanent)
- Controls what program to use for "sh" and "shroot". It may
- be any pathname, and is the name of the IRIX command that is
- invoked for "sh" and "shroot" commands. It is normally
- /bin/sh or /bin/csh; the default value comes from the SHELL
- environment variable. It is saved from session to session.
-
-
- sssshhhhoooorrrrtttt____nnnnaaaammmmeeeessss Display product name instead of description.
- boolean, default: off (permanent)
- Controls if the product name is displayed instead of the
- product description when the products are listed.
-
-
- sssshhhhoooowwww____ccccoooommmmmmmmaaaannnndddd____ppppaaaannnneeee
- Display the command pane on startup
- boolean, default: off (swmgr-only)
- Controls whether the command pane is shown on startup.
-
-
- sssshhhhoooowwww____ddddiiiisssskkkkssssppppaaaacccceeee
- Display diskspace summary
- boolean, default: on (inst-only permanent)
- Controls whether the diskspace is displayed by the "list",
- "step" and "recalculate" commands. Use the "admin space"
-
-
-
- PPPPaaaaggggeeee 33330000
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- command to display this summary even when this preference is
- set "off". See also "inst_terse_mode".
-
-
- sssshhhhoooowwww____ddddiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn____ppppaaaannnneeee
- Display the distribution pane on startup
- boolean, default: on (swmgr-only)
- Controls whether the distribution pane is shown on startup.
-
-
- sssshhhhoooowwww____eeeexxxxiiiissssttttiiiinnnngggg____ccccoooonnnnfffflllliiiiccccttttssss
- Display pre-existing conflicts
- boolean, default: off
- Controls whether pre-existing conflicts are displayed or
- not.
-
-
- sssshhhhoooowwww____ffffiiiilllleeeessss Display filenames during install
- boolean, default: off (permanent expert)
- Controls whether the name of each file is displayed as it is
- installed or removed. See also "overprint", to control
- whether these listed filenames are displayed on the same
- line or not. See also "verbose".
-
-
- sssshhhhoooowwww____hhhhiiiiddddddddeeeennnn____pppprrrreeeeffffeeeerrrreeeennnncccceeeessss
- Hide or present all preferences
- boolean, default: off (permanent expert)
- Controls whether the user is presented with the hidden
- preferences, in addition to the basic preferences. See also
- "inst_visible_preferences" and "swmgr_visible_preferences".
-
-
- sssshhhhoooowwww____lllleeeeggggeeeennnndddd Display list legend
- boolean, default: on (inst-only permanent)
- Controls whether the legend is displayed at the beginning of
- the output of the "list" command. See also
- "inst_terse_mode".
-
-
- sssshhhhoooowwww____lllliiiinnnntttt Show distribution consistency errors
- boolean, default: off (permanent expert)
- Controls whether to display any inconsistencies found while
- reading the distribution.
-
-
- sssshhhhoooowwww____lllloooogggg____ppppaaaannnneeee
- Display the log pane on startup
- boolean, default: off (swmgr-only)
- Controls whether the log pane is displayed on startup.
-
-
-
-
-
- PPPPaaaaggggeeee 33331111
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- sssshhhhoooowwww____ppppeeeerrrrcccceeeennnntttt____ddddoooonnnneeee
- Display task percentages
- boolean, default: on (inst-only expert)
- Controls whether percent-done messages are displayed in
- inst. See also "verbose".
-
-
- sssshhhhoooowwww____sssseeeelllleeeeccccttttiiiioooonnnnssss____ppppaaaannnneeee
- Display the selections pane on startup
- boolean, default: on (swmgr-only)
- Controls whether the selections pane is shown on startup.
-
-
- sssshhhhoooowwww____ssssttttaaaatttt____ppppaaaannnneeee
- Display the status pane on startup
- boolean, default: on (swmgr-only)
- Controls whether the status pane is shown on startup.
-
-
- sssshhhhoooowwww____ssssuuuubbbbttttaaaasssskkkkssss
- Print tasking information
- boolean, default: off
- Controls whether detailed information about tasks and sub-
- tasks is displayed.
-
-
- sssskkkkiiiipppp____rrrrqqqqssss Skip the requickstart process entirely
- boolean, default: off
- Controls whether to skip the requickstart process. Use this
- preference cautiously, since it can cause newly installed
- dynamic ELF programs to start-up less quickly.
-
-
- ssssmmmmaaaarrrrtttt____ccccoooonnnnffffiiiigggg____hhhhaaaannnnddddlllliiiinnnngggg
- Selectively install config(update) files
- boolean, default: on (permanent)
- If enabled, config(update) files will not be installed if
- the previously installed version has the same size and
- checksum as reported by the inst history file
-
-
- ssssppppaaaacccceeee____cccchhhheeeecccckkkk Controls space checking
- boolean, default: on
- Controls whether disk space checking is performed. Use
- cautiously, or you can run out of diskspace.
-
-
- ssssppppaaaacccceeee____uuuuppppddddaaaatttteeee____iiiinnnntttteeeerrrrvvvvaaaallll
- Seconds between disk space updates
- integer, default: 10 (swmgr-only permanent)
- Specifies how often the Disk Space area is automatically
- updated (in addition to updates that occur when the product
-
-
-
- PPPPaaaaggggeeee 33332222
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- selections change). If zero is specified, automatic updates
- are disabled.
-
-
- ssssttttaaaarrrrttttiiiidddd Initial id to assign for an unknown uid/gid
- integer, default: 60000 (permanent)
- This preference is only relevant if promptforid is "off".
- Inst or SoftwareManager will automatically assign unknown
- uid/gid values based on the value of "startid". After a
- given unknown uid or gid is assigned the value (startid),
- the next unknown uid/gid will be assigned (startid - 1), and
- the next (startid - 2), etc. It is recommended that startid
- be assigned a value that no current uids/gids possess. If
- inst or SoftwareManager automatically assigns a uid or gid
- to a file, it will write the mapping to /usr/adm/SYSLOG.
-
-
- ssssttttaaaarrrrttttuuuupppp____ssssccccrrrriiiipppptttt
- Control optional installation startup script handling
- default: prompt, choices: prompt ignore execute (expert)
- This preference is used to control how inst and
- SoftwareManager treat the inst.init startup script (if any)
- that accompanies the software distribution. If set to
- "prompt", the user is prompted before the script is
- executed. If set to "ignore", the startup script is ignored.
- If set to "execute" the startup script is run without
- confirmation from the user. Non-interactive installations
- (inst -a or swmgr -a -Vinteractive:off) will fail if a
- startup script is present, unless this preference is
- explicitly set on the command line with either
- -Vstartup_script:ignore or -Vstartup_script:execute. This
- preference is not saved across sessions, unless a line such
- as "startup_script:ignore" is manually added to the
- /var/inst/.swmgrrc file. For security reasons you are
- strongly advised against adding the line
- "startup_script:execute" to the .swmgrrc file.
-
-
- ssssttttrrrreeeeaaaammmm Controls type of overlays to be displayed
- default: maint, choices: maint feature (permanent_target)
- Controls type of overlays to be displayed. To switch
- between streams, normally the inst commands "install maint"
- and "install feature", or Install menu in Software Manager,
- should be used rather than setting this preference directly.
- A setting of "maint" causes feature stream overlay products
- to be hidden from the user. A setting of "feature" causes
- maintenance stream overlay products to be hidden from the
- user. Maintenance stream products and feature stream
- products are incompatible with one another. Maintenance
- stream products consist of bug fixes and changes required to
- support new hardware. Feature stream products consist of bug
- fixes and newly introduced features, possibly to take
-
-
-
- PPPPaaaaggggeeee 33333333
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- advantage of new hardware. Normally, the inst commands
- "install maint" and "install feature" should be used to
- switch from one stream to the other, because these commands
- modify the current selections in addition to setting the
- stream preference. In Software Manager, use the Install menu
- to switch between streams, after first opening a software
- distribution containing feature or maintenance products and
- choosing Customize Installation mode.
-
-
- ssssuuuupppppppprrrreeeessssssss____rrrrqqqqssss____eeeerrrrrrrroooorrrrssss
- Suppress error message on rqsread/rqsall failure
- boolean, default: true
- This option suppresses the inst warning message that
- accompanies an rqsread(1) or rqsall(1) error. The default is
- to suppress the message since there is no loss of
- functionality as the result of such a failure.
-
-
- sssswwwwmmmmggggrrrr____iiiinnnniiiittttiiiiaaaallll____lllleeeevvvveeeellll
- SoftwareManager product display level
- default: product, choices: product subsystem (swmgr-only
- permanent expert)
- Controls the initial level of products displayed.
-
-
- sssswwwwmmmmggggrrrr____vvvviiiissssiiiibbbblllleeee____pppprrrreeeeffffeeeerrrreeeennnncccceeeessss
- Set of optional preferences to display.
- multivalue, default: transient,gui, choices: none transient
- expert gui tty (swmgr-only permanent beginner)
- Controls the set of optional preferences displayed in the
- preferences dialog. See also "show_hidden_preferences".
-
-
- sssswwwwmmmmggggrrrrrrrrcccc____ppppaaaatttthhhh Search path for .swmgrrc preference files
- string, default: /var/inst:$rbase/var/inst:$rbase$HOME:$HOME
- (expert)
- Contains a colon-separated list of directories to search for
- preference files, such as ~/.swmgrrc, that contain
- preferences to be saved between sessions. The directories
- are searched in the order specified. Preference settings in
- the last .swmgrrc found have the highest precedence.
-
- Whenever you change the value of a "permanent" preference,
- its value will be saved in .swmgrrc (the one most recently
- loaded) and will remain set in future inst or
- SoftwareManager sessions.
-
- The "swmgrrc_path" can also be modified by setting the
- environment variable SWMGRRC_PATH. If the value is "none",
- then no .swmgrrc files will be read, or saved.
-
-
-
-
- PPPPaaaaggggeeee 33334444
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- ssssyyyymmmmlllliiiinnnnkkkk____mmmmooooddddeeee Create a symlink tree
- boolean, default: off (readonly)
- Controls whether inst or SoftwareManager operates in symlink
- mode. In this mode, all files (but not directories, config
- files, or noshare files) are installed as absolute symbolic
- links pointing to the corresponding file in the real tree.
- This preference can only be set on the command line, using
- -T<symlink_root>. See "symlink_root".
-
-
- ssssyyyymmmmlllliiiinnnnkkkk____rrrrooooooootttt Root of real tree in symlink mode
- string, default: NULL (readonly)
- Holds the root of the real tree to which symlinks point.
- This preference can only be set on the command line, using
- -T<symlink_root>. See "symlink_mode".
-
-
- ssssyyyysssslllloooogggg Log messages to /var/adm/SYSLOG
- boolean, default: off (expert)
- Controls whether inst or SoftwareManager will log errors and
- warnings to /var/adm/SYSLOG in addition to
- /var/inst/INSTLOG.
-
-
- ttttaaaarrrrggggeeeetttt Location of target tree
- string, default: / (readonly)
- Holds the name of the root directory on the local filesystem
- where files are installed or removed. SoftwareManager and
- inst do not install or remove files outside of the target.
- Normally during a live installation, the target is /, and in
- the miniroot it is /root. The -r command line option may be
- used to specify an alternate target.
-
-
- ttttiiiimmmmeeeeoooouuuutttt Network timeout in seconds
- integer, default: 120 (permanent)
- Holds the amount of time to wait for a reply from a remote
- host. If the remote machine does not respond after this
- time, the request is attempted again. See "network_retry".
- The default is two minutes; if your network is particularly
- slow, this may not be enough. If you receive errors
- regarding the network timeout, and you believe the access
- will succeed if given more time, increase the value of this
- preference. The value of timeout is saved from session to
- session.
-
-
- ttttoooooooollllnnnnaaaammmmeeee Name of invoked installation program.
- string, default: NULL
- Holds the name of the installation program, either "inst" or
- "swmgr" (SoftwareManager).
-
-
-
-
- PPPPaaaaggggeeee 33335555
-
-
-
-
-
-
- sssswwwwmmmmggggrrrr((((1111MMMM)))) sssswwwwmmmmggggrrrr((((1111MMMM))))
-
-
-
- ttttrrrraaaacccceeee Trace debugging
- multivalue, default: NULL, choices: none category checkpoint
- config conflict constructor cutpoint destructor diskless
- dispatcher dist errno file general gui hist http mach malloc
- orphan perm prod remote resource rules rqs selection space
- stat tape task all
- Controls which type of debugging information is displayed.
- Can be "all" or any combination of categories. Set to "none"
- to disable debugging.
-
-
- vvvveeeerrrrbbbboooosssseeee Display more detailed output
- boolean, default: off (permanent expert)
- When set "on", causes more status messages to be displayed.
- For finer control of the same facility, see "verbosity".
- See also "show_files", "show_percent_done" and
- "inst_terse_mode".
-
-
- vvvveeeerrrrbbbboooossssiiiittttyyyy Message verbosity display threshold
- integer, default: 2, choices: 0 to 6 (permanent)
- Controls the level of error and related info messages
- displayed. 0 for silent, 2 for verbose off (default), 4 for
- verbose on, 6 for all messages. For another way to control
- this setting, see "verbose".
-
-
- vvvveeeerrrriiiiffffyyyy____cccchhhheeeecccckkkkssssuuuummmm
- Verify checksum of file during install
- boolean, default: on (permanent expert)
- During the installation, verify the checksum of each file as
- it is uncompressed or read from the archive.
-
-
- wwwwrrrraaaappppmmmmooooddddeeee Wrap/truncate long lines in display
- default: wrap, choices: wrap truncate (inst-only permanent)
- Controls the display of long subsystem descriptions by the
- "list" command. In "wrap" mode, the part of the description
- that overflows the right margin of the screen is shown
- indented on the next line. In "truncate" mode, the line is
- truncated near the right margin. The "step" command always
- uses truncate mode, regardless of the setting of this
- preference. It is "wrap" by default and saved from session
- to session.
-
-
- SSSSEEEEEEEE AAAALLLLSSSSOOOO
- distcp(1M), inst(1M), showfiles(1M), showprods(1M), versions(1M),
- netscape(1M), tar(1M) and _I_R_I_X _A_d_m_i_n: _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d
- _L_i_c_e_n_s_i_n_g.
-
-
-
-
-
- PPPPaaaaggggeeee 33336666
-
-
-
-